home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / readobj.exe / READOBJ.DOC next >
Text File  |  1992-08-19  |  5KB  |  96 lines
  1. ╔════════════════════════════════════════════════════════════════════════╗
  2. ║ This is the complete commercial package. It is being distributed       ║
  3. ║ electronically in order to address the rising demand for CCS software  ║
  4. ║ products. By distributing it in this manner, we avoid the handling     ║
  5. ║ involved in distribution by mail, advertising, and so on, and reduce   ║
  6. ║ YOUR cost to the [minimal] licensing fee that is necessary in order to ║
  7. ║ comply with copyright laws. Licensing is, nevertheless, required.      ║
  8. ╟────────────────────────────────────────────────────────────────────────╢
  9. ║ For the latest versions of CCS software, consult your local computer   ║
  10. ║ bulletin board systems, or else log on to CompuServe, access the IBM   ║
  11. ║ File Finder ("GO IBMFF"), and search for files with the keywords of    ║
  12. ║ "JOAN", "RIFF", or the name of the program that you are looking for.   ║
  13. ╟───────────────────────────────────────┬────────────────────────────────╢
  14. ║ COMPUTERWISE CONSULTING SERVICES      │    Voice Mail: (703) 450-7175  ║
  15. ║ P.O. Box 813                          │    Internet:   bob@grebyn.com  ║
  16. ║ McLean, VA 22101 USA                  │    CompuServe:      72355,362  ║
  17. ╚═══════════════════════════════════════╧════════════════════════════════╝
  18.  
  19. Product      : Joan Riff's READOBJ OBJ/LIB file dumper
  20. Version      : 1.9 (Aug 19 1992)
  21. Licensing fee: $10
  22.  
  23. This program dumps .OBJ and .LIB files in a human-readable format.
  24.  
  25. CAVEAT: Every compiler writer seems to want to [re]define the format
  26.         of object files. This program handles *MOST* of the known
  27.         Microsoft and Borland DOS object records, but no attempt has
  28.         been made to keep up with the multitudinous off-the-wall
  29.         records which are introduced practically daily by overzealous
  30.         compiler writers.
  31.  
  32. Use: readobj [flags] filename [[flags] filename]...
  33.  
  34. 'filename'  the name of an .OBJ or .LIB file to be dumped.
  35.             Wildcards are accepted in filenames.
  36.  
  37. 'flags'     may be preceded by '+' to turn an option ON, or by '-' to
  38.             turn it back off.
  39.  
  40.             Lowercase flags identify single object file record types.
  41.             Uppercase flags generally combine a specific function with
  42.             a select group of record type.
  43.  
  44.  Flag  Record     Description
  45.  ----  ------     -----------
  46.   ±A              Affects *ALL* lower-case flags (record types)
  47.   ±B              Both Block Start (BLKDEF) & Block End (BLKEND)
  48.   ±E              Externals (EXTDEF) & Publics (LOCSYM & PUBDEF)
  49.   ±F              Display filenames being processed
  50.   ±H   (all)      Dump raw records in HEX
  51.   ±L   (all)      Display record positions in file
  52.   ±M              Both module start (THEADR) and module end (MODEND)
  53.   ±P              Special Publics (LOCSYM & PUBDEF) report
  54.   ±R              Special Externals (EXTDEF/LOCSYM/PUBDEF) report
  55.   ±S   MODEND     Special true in-memory module size report
  56.   ±U   (unknown)  Handle unknown record types
  57.   ±V              Verbose output (where applicable)
  58.   ±b   BLKDEF     Block start
  59.   ±c   COMENT     COMENT information
  60.   ±e   EXTDEF     External information
  61.   ±f   FIXUPP     Fix up information
  62.   ±g   GRPDEF     GROUP information
  63.   ±i   LIDATA     LIDATA
  64.   ±k   BLKEND     Block end
  65.   ±l   LOCSYM     Locsym declarations (like PUBDEF)
  66.   ±m   THEADR     Module start info
  67.   ±n   LNAMES     Names
  68.   ±o   MODEND     Module end info
  69.   ±p   PUBDEF     Public declarations
  70.   ±q   LPUBDF     Local (debugger) declarations
  71.   ±s   SEGDEF     Segment information
  72.   ±t   TYPDEF     Typedef information
  73.   ±u   COMDEF     Communal variables
  74.   ±v   LEDATA     Enumerated data
  75.   ±w   MSLIBR     Library header
  76.   ±x   MSLEND     Library trailer
  77.   ±y   LINNUM     Line number information
  78.  
  79. The following special flags may be preceded by either '-' or '+'.
  80. Which one is used is irrelevant. The effect is the same regardless:
  81.  
  82.   -1nnnn    Start dumping at byte offset nnnn within the file.
  83.   -2nnnn    End dumping with byte offset nnnn within the file.
  84.  
  85.             With both of the above flags, nnnn may be expressed as:
  86.  
  87.                nnnn       Interpreted as a decimal number.
  88.              0xnnnn       Interpreted as a hexadecimal number.
  89.                nnnnK      Interpreted as a decimal number of K bytes.
  90.  
  91. Example: Perhaps the most common use of this program is to display the
  92.          *TRUE* (i.e. - in-memory) sizes of modules, which can be
  93.          accomplished (for a given library FOO.LIB) with:
  94.  
  95.              readobj +SV FOO.LIB >sizes.out
  96.